//
//  MusicBrainzCache.swift
//  Aural
//
//  Copyright © 2025 Kartik Venugopal. All rights reserved.
//
//  This software is licensed under the MIT software license.
//  See the file "LICENSE" in the project root directory for license terms.
//
import Foundation

///
/// Caches cover art retrieved from **MusicBrainz** for efficiency when performing repeated lookups
/// for the same artist / album.
///
/// While the app is running, the cache is in-memory, and it is persisted to disk upon app exit, then loaded
/// back into memory upon subsequent app startup.
///
class MusicBrainzCache: PersistentModelObject {
    
    let preferences: MusicBrainzPreferences
    
    // For a given artist / release title combo, cache art for later use (other tracks from the same album).
    var releasesCache: ConcurrentCompositeKeyMap<String, CachedCoverArtResult> = ConcurrentCompositeKeyMap()
    var recordingsCache: ConcurrentCompositeKeyMap<String, CachedCoverArtResult> = ConcurrentCompositeKeyMap()
    
    var onDiskReleasesCache: ConcurrentCompositeKeyMap<String, URL> = ConcurrentCompositeKeyMap()
    var onDiskRecordingsCache: ConcurrentCompositeKeyMap<String, URL> = ConcurrentCompositeKeyMap()
    
    let baseDir: URL = FilesAndPaths.subDirectory(named: "musicBrainzCache")
    private lazy var releasesDir: URL = baseDir.appendingPathComponent("releases", isDirectory: true)
    private lazy var recordingsDir: URL = baseDir.appendingPathComponent("recordings", isDirectory: true)
    
    private let diskIOOpQueue: OperationQueue = OperationQueue(opCount: System.physicalCores, qos: .utility)
    
    private lazy var messenger = Messenger(for: self)
    
    init(state: MusicBrainzCachePersistentState?, preferences: MusicBrainzPreferences) {
        
        self.preferences = preferences
        messenger.subscribe(to: .Application.willExit, handler: onAppExit)
    }
    
    func getCoverArt(forTrack track: Track) -> CoverArt? {
        
        guard let artist = track.artist?.lowerCasedAndTrimmed() else {return nil}
        
        if let album = track.album?.lowerCasedAndTrimmed(), let coverArt = getForRelease(artist: artist, title: album)?.art {
            return coverArt
        }
        
        if let title = track.title?.lowerCasedAndTrimmed() {
            return getForRecording(artist: artist, title: title)?.art
        }
        
        return nil
    }
    
    func getForRelease(artist: String, title: String) -> CachedCoverArtResult? {
        releasesCache[artist, title]
    }
    
    func getForRecording(artist: String, title: String) -> CachedCoverArtResult? {
        recordingsCache[artist, title]
    }
    
    func putForRelease(artist: String, title: String, coverArt: CoverArt?) {
        
        releasesCache[artist, title] = coverArt != nil ? CachedCoverArtResult(art: coverArt) : .noArt
        
        if preferences.enableOnDiskCoverArtCache, let foundArt = coverArt {
            persistForRelease(artist: artist, title: title, coverArt: foundArt)
        }
    }
    
    func persistForRelease(artist: String, title: String, coverArt: CoverArt) {
        
        // Write the file to disk (on-disk caching)
        diskIOOpQueue.addOperation {
            
            self.releasesDir.createDirectory()
            let file = self.releasesDir.appendingPathComponent("\(artist)-\(title).jpg", isDirectory: false)
            
            do {

                try coverArt.originalImage?.image.writeToFile(fileType: .jpeg, file: file)
                self.onDiskReleasesCache[artist, title] = file
                
            } catch {
                NSLog("Error writing image file \(file.path) to the MusicBrainz on-disk cache: \(error)")
            }
        }
    }
    
    func putForRecording(artist: String, title: String, coverArt: CoverArt?) {
        
        recordingsCache[artist, title] = coverArt != nil ? CachedCoverArtResult(art: coverArt) : .noArt
        
        if preferences.enableOnDiskCoverArtCache, let foundArt = coverArt {
            persistForRecording(artist: artist, title: title, coverArt: foundArt)
        }
    }
    
    func persistForRecording(artist: String, title: String, coverArt: CoverArt) {
        
        // Write the file to disk (on-disk caching)
        diskIOOpQueue.addOperation {
            
            self.recordingsDir.createDirectory()
            let file = self.recordingsDir.appendingPathComponent("\(artist)-\(title).jpg", isDirectory: false)
            
            do {
            
                try coverArt.originalImage?.image.writeToFile(fileType: .jpeg, file: file)
                self.onDiskRecordingsCache[artist, title] = file
                
            } catch {
                NSLog("Error writing image file \(file.path) to the MusicBrainz on-disk cache: \(error)")
            }
        }
    }
    
    func onDiskCachingEnabled() {
        
        // Go through the in-memory cache. For all entries that have not been persisted to disk, persist them.
        
        for (artist, releaseTitle, coverArtResult) in releasesCache.entries {

            if let coverArt = coverArtResult.art, onDiskReleasesCache[artist, releaseTitle] == nil {
                persistForRelease(artist: artist, title: releaseTitle, coverArt: coverArt)
            }
        }
        
        for (artist, recordingTitle, coverArtResult) in recordingsCache.entries {
            
            if let coverArt = coverArtResult.art, onDiskRecordingsCache[artist, recordingTitle] == nil {
                persistForRecording(artist: artist, title: recordingTitle, coverArt: coverArt)
            }
        }
    }
    
    func onDiskCachingDisabled() {
        
        // Caching is disabled
        
        onDiskReleasesCache.removeAll()
        onDiskRecordingsCache.removeAll()
        
        diskIOOpQueue.addOperation {
            self.baseDir.delete()
        }
    }
    
    func cleanUpUnmappedFiles() {
        
        diskIOOpQueue.addOperation {
            
            // Clean up files that are unmapped.
            
            if let releasesImgFiles = self.releasesDir.children {
                
                let mappedFiles: Set<URL> = Set(self.onDiskReleasesCache.entries.map {$0.2})
                
                let unmappedFiles = releasesImgFiles.filter {!mappedFiles.contains($0)}
                
                // Delete unmapped files.
                for file in unmappedFiles {
                    file.delete()
                }
            }
            
            if let recordingsImgFiles = self.recordingsDir.children {
                
                let mappedFiles: Set<URL> = Set(self.onDiskRecordingsCache.entries.map {$0.2})
                
                let unmappedFiles = recordingsImgFiles.filter {!mappedFiles.contains($0)}
                
                // Delete unmapped files.
                for file in unmappedFiles {
                    file.delete()
                }
            }
        }
    }
    
    // This function is invoked when the user attempts to exit the app.
    func onAppExit() {
        
        // Wait till all disk I/O operations have completed, before allowing
        // the app to exit.
        diskIOOpQueue.waitUntilAllOperationsAreFinished()
    }
    
    var persistentState: MusicBrainzCachePersistentState {
        
        var releases: [MusicBrainzCacheEntryPersistentState] = []
        var recordings: [MusicBrainzCacheEntryPersistentState] = []
        
        for (artist, title, file) in self.onDiskReleasesCache.entries {
            releases.append(MusicBrainzCacheEntryPersistentState(artist: artist, title: title, file: file))
        }
        
        for (artist, title, file) in self.onDiskRecordingsCache.entries {
            recordings.append(MusicBrainzCacheEntryPersistentState(artist: artist, title: title, file: file))
        }
        
        return MusicBrainzCachePersistentState(releases: releases, recordings: recordings)
    }
}

struct CachedCoverArtResult {
    
    let art: CoverArt?
    var hasArt: Bool {art != nil}
    
    static let noArt: CachedCoverArtResult = CachedCoverArtResult(art: nil)
}
